$ tiger db restore public_schema_dump.sql cjfk38bq1w
⚙️  Preparing restore...
📦 Restoring database...

✓ Restore completed in 1.4s

📊 1 table • 3 views • 1005 functions • 1 sequence • 1 index
📈 10.0K rows

$ tiger db restore --help
Restore a PostgreSQL database from a dump file to a database service.

The service ID can be provided as an argument or will use the default service
from your configuration.

Supports multiple dump formats:
  - Plain SQL (.sql, .sql.gz) - Restored using psql
  - Custom format (.dump, .custom) - Restored using pg_restore
  - Tar format (.tar) - Restored using pg_restore
  - Directory format - Restored using pg_restore

For TimescaleDB databases, automatically detects and runs pre_restore() and
post_restore() hooks for optimal hypertable restoration.

Cloud-Friendly Defaults:
  - Continues past benign errors (like "already exists") by default
  - Uses --no-owner and --no-privileges for custom/tar/directory formats
  - Performs preflight checks before starting restore

Examples:
  # Restore plain SQL dump to default service
  tiger db restore backup.sql

  # Restore to specific service
  tiger db restore backup.sql svc-12345

  # Restore custom format dump with 4 parallel jobs (faster)
  tiger db restore backup.dump --jobs 4

  # Read from stdin
  pg_dump -Fc mydb | tiger db restore - --format custom

  # Clean existing objects before restore (DESTRUCTIVE - requires confirmation)
  tiger db restore backup.sql --clean --if-exists

  # Stop on first error (not recommended for cloud environments)
  tiger db restore backup.sql --on-error-stop

  # Verbose mode for debugging
  tiger db restore backup.sql --verbose

Note for AI agents: This command may be destructive when used with --clean.
Always confirm with the user before executing, especially with --clean flag.

Usage:
  tiger db restore <file-path> [service-id] [flags]

Flags:
      --clean                  Drop database objects before recreating (DESTRUCTIVE)
      --confirm                Skip confirmation prompts (for automation)
  -d, --database string        Target database name (defaults to tsdb)
      --format string          Dump format: plain, custom, directory, tar (auto-detected if not specified)
  -h, --help                   help for restore
      --if-exists              Use IF EXISTS when dropping objects (use with --clean)
  -j, --jobs int               Parallel restore jobs (for custom/directory/tar formats only) (default 1)
      --no-owner               Skip restoration of object ownership (recommended for cloud) (default true)
      --no-privileges          Skip restoration of access privileges (recommended for cloud) (default true)
      --no-timescaledb-hooks   Disable TimescaleDB hooks (even if detected)
      --on-error-stop          Stop on first error (default: continue past errors like 'already exists')
      --quiet                  Suppress progress output
      --role string            Database role/username (default "tsdbadmin")
      --single-transaction     Wrap restore in a single transaction (slower but safer)
      --timescaledb-hooks      Force enable TimescaleDB pre/post restore hooks
      --verbose                Show detailed restore process